====== Gitolite ======

Gitolite est une réécriture de Gitosis, par Sitaram Chamarty. Il permet de gérer des dépôts [[:Git]] à l'aide d'un utilisateur spécifique sur un serveur, en leur attribuant des utilisateurs ou groupes d'utilisateurs, des droits spécifiques comme la lecture, écriture, etc. Il possède un fichier de configuration complètement diffèrent qui permet le contrôle d'accès sur chaque branche, incluant des spécifications comme qui peut ou ne peut pas revenir sur une branche donnée.

Gitolite utilise évidement les clés publiques ssh pour l'ajout d'utilisateur, mais il est intéressant car il interdit ses utilisateurs de se connecter à un shell de l'utilisateur des dépôts. C'est l'un des points importants de sécurité auxquels répond Gitolite.

===== Pré-requis =====

Gitolite utilise un utilisateur spécifique sur le serveur pour gérer les dépôts.

Dans cette documentation nous considérerons les termes suivants :

  * **''server''** : serveur ;
  * **''admin''** : administrateur du serveur ;
  * **''git''** : utilisateur Git du serveur (s'il n'est pas créé, il peut l'être avec ''sudo adduser git'').

Nous considérons donc que les utilisateurs **''admin''** et **''git''** sont sur **''server''**.

**''admin''** doit avoir un accès ssh autorisé sur le compte de l'utilisateur **''git''**. Si ce n'est pas le cas, sur **''server''**, créez une paire de clés (publique et privée) pour **''admin''** avec :

  ssh-keygen

Puis ajoutez la clé publique aux clés autorisées de **''git''** avec :

  ssh-copy-id -i ~/.ssh/id_rsa.pub git@localhost

Cette commande a pour effet d'ajouter votre clé au fichier ''~/.ssh/authorized_keys'' de **''git''**.

Gitolite nécéssite évidement Git. Si ce n'est pas fait, [[:tutoriel:comment_installer_un_paquet|installez donc le paquet]] [[apt://git-core|git-core]].

===== Installation =====

L'installation se fera depuis le dossier personnel de l'utilisateur **''admin''** de votre serveur **''server''**.

Récupérez les sources de Gitolite sur Github, avec :

  git clone git://github.com/sitaramc/gitolite.git

Déplacez-vous dans le dossier des sources :

  cd gitolite

Lancez à présent le script d'installation de Gitolite :

  src/gl-easy-install git localhost admin

Cela signifie que vous lancez l'installation en utilisant **''git''** comme utilisateur contenant les dépôts Git, sur votre serveur (ici la machine sur laquelle vous êtes connectée, donc ''localhost'' représente **''server''**) et utilisez **''admin''** comme administrateur des dépôts.

Il vous sera demandé plusieurs choses au cours de l'exécution du script. Si vous n'êtes pas familié avec Git, utilisez les propositions par défaut.

===== Configuration =====

La configuration de Gitolite est simple. Elle crée un dépôt de configuration nommé ''gitolite-admin'' sur le serveur, et son clône dans le répertoire personnel de **''admin''**. C'est dans celui-ci que nous configurerons nos dépôts. cette configuration comprend un fichier et un dossier :

  * **''conf/gitolite.conf''** : fichier de configuration de Gitolite, contenant les dépôts, leurs utilisateurs/groupes et leurs droits associés ;
  * **''keydir/''** : dossier contenant les clés publiques des utilisateurs, sous la forme ''user_name.pub''.

La configuration de Gitolite utilisant un dépôt Git spécifique, il sera nécessaire de //commiter// les changements effectués pour qu'ils prennent effet, c'est pour cela qu'il est nécessaire de se situer dans le dossier de configuration pour appliquer des changements.

Rendez-vous donc dans le dépôt ''gitolite-admin'' de votre utilisateur **''admin''** :

  cd ~/gitolite-admin

==== Créer un dépôt ====

Pour créer un dépôt, [[:tutoriel:comment_editer_un_fichier|éditez votre fichier]] ''conf/gitolite.conf''. Ce fichier se présente sous la forme :

<code>
repo repo1
    RW+            = admin
</code>

ce qui signifie que le dépôt ''repo1'' (//repository// en anglais) admet un utilisateur (**''admin''**) qui possède les droits de lecture (''R'') et d'écriture (''W'').

Pour ajouter un dépôt //my_repo//, ajoutez donc :

<code>
repo my_repo
    RW+                 = user1 user2 user3
</code>

Une fois votre fichier édité, sauvegardé puis //commitez// les changements :

  git add conf/gitolite.conf
  git commit -m "add repository my_repo"
  git push

//my_repo// sera automatiquement créé après le //push// dans ''/home/git/repositories/''.

==== Ajouter un utilisateur ====

Pour ajouter un utilisateur, il suffit d'ajouter sa clé publique au dossier ''keydir/'' dans un fichier nommé ''username.pub''.

Pour ajouter par exemple l'utilisateur ''user1'', [[:tutoriel:comment_editer_un_fichier|crééz le fichier]] ''keydir/user1.pub'' contenant sa clé publique.

<note>
Cette clé publique est habituellement créée avec la commande ''ssh-keygen'' (executée depuis le poste de l'utilisateur à ajouter) et est contenue dans le fichier ''~/.ssh/id_rsa.pub'' de l'utilisateur.
</note>

Une fois son fichier ajouté, //commitez// les changements :

  git add keydir/user1.pub
  git commit -m "add user user1"
  git push

<note tip>
Un utilisateur peut avoir plusieurs clés publiques, pratique dans deux cas :
  * **''admin''** est le nom utilisé pour l'administration de **''server''**, mais aussi le nom utilisé sur une machine de développement ;
  * un utilisateur peut développer sur plusieurs machine, par exemple son pc et son portable.

Vous pouvez donc définir plusieurs clés pour un même utilisateur en créant des fichiers ''user1.pub'', ''user1@laptop.pub'', ''user1@foo.pub'', etc.
</note>

==== Ajouter un groupe ====

Pour ajouter un groupe, il suffit de le définir dans le fichier ''gitolite.conf''. [[:tutoriel:comment_editer_un_fichier|Éditez donc le fichier]] ''conf/gitolite.conf'' et ajoutez-y un groupe au début du fichier comme ceci :

  @group1 = user1 user2 user3

<note>
Le groupe ''@all'' est un groupe déjà définit, représentant tout le monde.
</note>

Pour assigner un groupe à un dépôt, il suffit de le définir comme pour un utilisateur :

<code>
repo my_repo
    RW+                 = @group1
</code>

Puis //commitez// les changements avec :

  git add conf/gitolite.conf
  git commit -m "add group group1 and assign it to repo my_repo"
  git push

<note help>
Pour une configuration plus poussée, comme les permissions sur les branches, Gitweb, etc, voir l'exemple de [[http://github.com/sitaramc/gitolite/blob/master/conf/example.conf|fichier de configuration]] de Gitolite.
</note>

==== Gestion des droits ====

Comme vous l'avez remarqué, les droits sont définis à des utilisateurs pour un dépôt donné. Il existe 3 types de droits :

  * **R** : droit de lecture uniquement (l'utilisateur peut effectuer un ''git clone'', etc) ;
  * **RW** : droit de lecture et écriture (l'utilisateur peut effectuer un ''git clone'', ''git push'', etc) ;
  * **RW+** : droit de lecture et écriture, ainsi que les //rewind permissions//, c'est-à-dire le droit de supprimer des étapes du projet, comme par exemple le permet la commande ''git reset --hard HEAD^''.

===== Utilisation =====

==== Accès à un dépôt ====

Après avoir ajouter un utilisateur, celui-ci peut //cloner// un dépôt avec :

  git clone git@server:my_repo

<note>
Si votre version de Git de **''server''**  est ''1.6.0.*'', vous pourrez obtenir des erreurs au //clone// d'un dépôt **vide**. Pour contourner ce problème, vous pouvez mettre à jour votre la version de Git de **''server''**, ou contourner le problème chez le client en //clonant// le dépôt de cette manière :

  mkdir repo1
  cd repo1
  git init
  git commit --allow-empty -m "initial repository"
  git remote add origin git@server:repo1
  git push origin master
  git config push.default matching
</note>

<note>
Dans le cas où l'utilisateur **''admin''** veut développer sur **''server''**, il doit //cloner// un dépôt avec :

  git clone gitolite:my_repo
</note>

===== Voir aussi =====

  * **(en)** [[http://github.com/sitaramc/gitolite|page de Gitolite]] sur Github ;
  * **(en)** [[http://github.com/sitaramc/gitolite/blob/master/conf/example.conf|Un exemple de fichier de configuration complet]] ;
  * **(fr)** documentation de [[:git|Git]] du wiki ;

----

//Contributeurs : [[:utilisateurs/v0n]].//
